home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / mdf31 / mdf.doc < prev    next >
Text File  |  1993-04-21  |  7KB  |  163 lines
  1.  
  2.  
  3.           MIDI DATA FILER ver 3.1, April 1993 by Kai Risku
  4.           ================================================
  5.  
  6. This is a very easy-to-use program that will send and receive midi sysex
  7. dumps on a PC. The dumps are stored as raw files and are compatible with
  8. sysex dumps used by most sequencing programs. The dumps can be several
  9. hundred kilobytes in size (limited by available memory).
  10.  
  11. The program requires a MPU-compatible midi interface and can be
  12. configured for any base address (interrupts are not used at all).
  13.  
  14.  
  15. How to save MIDI-data to a file:
  16. ================================
  17.  
  18. You just start MDF with a non-existent filename as argument. When MDF
  19. reports 'Start dump' you can start a sysex-dump manually from your
  20. synthesizer or press any key to abort. A dot will be displayed for every
  21. sysex block received (so you can see that the computer is actually
  22. getting some data).
  23.  
  24. After the dump is done, MDF will report how many bytes have been
  25. received, save those in the file you specified and exit automatically.
  26.  
  27. The amount of data you can receive is limited by the available memory
  28. below 640k (minus about 40k for MDF itself).
  29.  
  30.  
  31. How to send the data back to the synthesizer:
  32. =============================================
  33.  
  34. Oh, you have already guessed that one, but I just want to say it anyway.
  35. Run MDF with the name of the file you want to send to your synthesizer
  36. as the argument. MDF will send the contents of the file and inform you
  37. of how many bytes has been sent. You can press ESC if you wish to abort
  38. the transfer.
  39.  
  40.  
  41.  
  42. Configuring MDF using the MDF.INI file:
  43. =======================================
  44.  
  45. When starting up MDF, the program will look for a file named MDF.INI in
  46. the same directory as MDF.EXE is in. If the INI-file cannot be found,
  47. one will be created using some default values. The file is in plain
  48. ASCII format and can be edited with any ordinary ascii editor. These are
  49. the valid options and what they specify:
  50.  
  51. Delay1=n        where n is a decimal integer specifying the delay
  52.                 between each byte sent. A larger value means
  53.                 slower sending.
  54.  
  55. Delay2=n        where n is a decimal integer specifying a delay
  56.                 in milliseconds between each sysex block sent.
  57.  
  58. Timeout=n       where n is a decimal integer in milliseconds specifying
  59.                 how long MDF should wait for more data before finishing.
  60.  
  61. Extension=ext   where ext is a filename extension with a maximum
  62.                 of three characters. This extension will be used if
  63.                 MDF is invoked with a filename with no extension.
  64.                 If this option is missing, the default extension
  65.                 will be SYX. Using filenames with no extension at
  66.                 all requires either a period after the filename
  67.                 on the command line, or removing the characters
  68.                 to the right of the equal sign in MDF.INI.
  69.  
  70. Port=addr       where addr is the address of the midi interface. The
  71.                 address can be given in decimal or hex. To specify
  72.                 hex mode, you must either have '0x' before the address,
  73.                 or the character 'h' after. The default address can be
  74.                 written these ways; Port=816, Port=0x330 or Port=330h
  75.  
  76.  
  77.  
  78. If it does not work:
  79. ====================
  80.  
  81. - If your MPU-compatible interface is not installed on the default
  82.   port address 330h, you must set the correct address in MDF.INI.
  83. - some synthesizers can choke if the computer dumps data too fast.
  84.   Increase the delays specified in MDF.INI to slow down the sending.
  85. - There can be some problems when receiving a dump if the
  86.   synthesizer dumps data too fast and you have a slow computer.
  87.   You should therefore keep an eye on the size of the received
  88.   data as this will be too small if data has been lost.
  89. - You cannot use handshake-dumps with this program, because
  90.   practically every synth has its own format for this.
  91.   Make sure that you start a one-way dump on your synthesizer.
  92.  
  93.  
  94. Revision history
  95. ================
  96.  
  97. New in version 3.1:
  98.         Fixed bug that occasionally saved some garbage at the
  99.         end of the file when receiving. Tweaked the documentation.
  100. New in version 3.0:
  101.         Sysex dumps are no longer limited to 64 kbytes. Receiving
  102.         sysex data is only limited by your dos memory (below 640k).
  103.         The receive timeout can now be specified in MDF.INI.
  104.         Program selfcheck added and large portions of the code
  105.         rewritten to improve the program in several ways.
  106. New in version 2.6:
  107.         The address of the midi interface can be set in MDF.INI
  108. New in version 2.5:
  109.         You can now change the default filename extension
  110.         using MDF.INI
  111. New in version 2.4:
  112.         Ctrl-C is now trapped, so you cannot break out of the
  113.         program and leave the midi interface in UART mode.
  114. New in version 2.3:
  115.         Added an INI-file for user-configurable delays while
  116.         sending. Modified text output and removed some
  117.         unnecessary texts.
  118. New in version 2.2:
  119.         More code cleanup. Incoming data during sysex-send
  120.         to synthesizer will be sent back out when possible.
  121.         Error-handling improved.
  122. New in version 2.1:
  123.         The default extension MDF for files created was changed
  124.         to SYX for compatibility with other software.
  125.         Active sensing has earlier caused some trouble, but
  126.         this has now been fixed as well as a small bug causing
  127.         a time-out if you don't start the dump fast enough
  128.         after you started the program.
  129. New in version 2.0:
  130.         Document added (this piece of text). Improved routines
  131.         with faster code. Corrected some minor bugs. This was
  132.         the first "official" release.
  133.  
  134.  
  135.  
  136. #include <std_disclaimer.h>:
  137. ============================
  138.  
  139.                 Copyright (c) 1990-1993 Kai Risku
  140.  
  141. MDF is offered to you "AS IS" without any warranty. This software has
  142. been thoroughly tested but no guarantee is given that it will work on
  143. every computer. The copyright owner may not be held liable for any
  144. damages, direct or consequential, which may result from the the use of
  145. this program.
  146.  
  147. This program is freely distributable. You may use the software and
  148. share it with all your friends (and foes) as long as the program is
  149. supplied in its original, unmodified form, which includes this
  150. documentation. This program must not be distributed for profit.
  151.  
  152. If you have any questions, ideas, suggestions for improvements or if
  153. you are interested in the source then feel free to contact me...
  154.  
  155. A nice postcard would be appreciated!
  156.  
  157.  
  158. Snailmail:      Kai Risku         Email (internet):  Kai.Risku@hut.fi
  159.                 Kronvik
  160.                 65410 Sundom
  161.                 Finland
  162.  
  163.